Update page 'InstallationNotes'

1 files changed, 2 insertions, 115 deletions

diff --git a/InstallationNotes.md b/InstallationNotes.md
index d3138fd..4b41d24 100644
--- a/InstallationNotes.md
+++ b/InstallationNotes.md
@@ -22,119 +22,6 @@ Use this if you want manual control over tt-rss updates or an ability to revert
 

 → [Installation guide (static)](https://git.tt-rss.org/fox/ttrss-docker-compose/src/static-dockerhub/README.md)

 

------

+----

 

-### Installing on a host machine (not recommended)

-

-Before you begin, you’ll need to verify the following:

-

- - You need access to a hosting/VDS running a http server and a database

-(mysql or postgresql). Your database should properly support unicode.

- - You will need to acquire database credentials, i.e. login, password,

-and a database name. If you don’t have a database already created, you

-need to do so before installing. Tiny Tiny RSS can coexist with other

-applications in a shared database, creating a dedicated one is not

-necessary.

- - Your http server should be running PHP version 5.6 or newer. Enabling

-PHP [opcode cache](https://www.google.com/search?q=php+enable+opcode+cache) is recommended.

-See also: [PhpCompatibilityNotes](wiki/PhpCompatibilityNotes).

- - This manual assumes you have basic knowledge of [Git SCM](https://www.google.com/search?q=git+howto).

-

-#### Host installation overview

-

- - Clone tt-rss repository using Git. Always use latest Git code from master branch.

- 

-```

-git clone https://git.tt-rss.org/fox/tt-rss.git tt-rss

-```

-

-Alternatively, you can clone the repository on your local machine and

-upload files to the server using FTP or any other means available to

-you.

-

- - Verify that you can open <code>http://your.site/tt-rss/install/</code>

-

- - Proceed with the installation using the easy installer. It will ask

-your database credentials and a full URL on which tt-rss will be

-accessed, for example <code>http://your.site/tt-rss/install/</code>.

-It is required that the URL is an externally accessible one (if any),

-don’t use <code>localhost</code> there. If you are deploying tt-rss on LAN, 

-you can disregard this requirement.

-

- - Easy installer will generate <code>config.php</code> for you,

-after you have entered your database credentials and initialized tt-rss

-database. You will need to either copy text from the installer and paste

-it into <code>config.php</code> on the server, or, if possible, the

-installer will be able to do it for you automatically.

-

- - It is suggested that you read through <code>config.php</code> to see

-if you need to enable additional functionality or change default

-configuration values.

-

- - After finishing with the installer, open your Tiny Tiny RSS

-installation at <code>http://yoursite/tt-rss/</code> and login with

-default credentials (username: <code>admin</code>, password:

-<code>password</code>).

-

-- **Open preferences and change your password!**

-

-- You will also need to decide on the method tt-rss uses to update

-feeds. This is a separate topic, outlined in [UpdatingFeeds](wiki/UpdatingFeeds).

-

-- If all went well, you may proceed to use tt-rss normally. Create a

-separate non-admin user, login under it, and start importing your feeds,

-subscribing, and configure it to your taste.

-

-Don’t forget to read [UpdatingFeeds](wiki/UpdatingFeeds) otherwise your feeds won’t update

-automatically.

-

-See also: [SecuringCacheDirectories](wiki/SecuringCacheDirectories)

-

-#### Take a look at available plugins

-

-There are many plugins written for tt-rss. You can see the list here: [Plugins](wiki/Plugins).

-

------

-

-## Upgrading Tiny Tiny RSS

-

-It is highly recommended to temporarily disable any third party themes

-and user CSS customizations before upgrading. Don’t forget to empty your

-browser cache if you experience weird bugs right after upgrading.

-

-Note that you should upgrade to the latest version available, installing

-intermediate releases sequentially is not needed.

-

-### Upgrading with Git

-

-#### Update base tt-rss code

-

-Change to tt-rss directory on your server and run ``git pull origin master``.

-

-#### Merge new config.php directives and/or update the database

-

-After the files have been upgraded to newer versions, open tt-rss. It

-may complain about missing directives in <code>config.php</code>. If

-that happens, you will need to either merge new stuff from

-<code>config.php-dist</code> to your <code>config.php</code> or remove

-<code>config.php</code> and rerun the installer.

-

-**DO NOT INITIALIZE DATABASE when upgrading. This will remove all your

-tt-rss data.**

-

-Afterwards, you may be redirected to the database updater. Log in with

-admin credentials and follow instructions.

-

-Finishing that, you should be able to use tt-rss normally by logging in

-with your normal account.

-

-#### Post-upgrade tasks

-

-1. You might need to clear your browser cache if you experience CSS or

-script-related issues, older scripts might have stuck in it.

-2. Do not copy cache directories from your old tt-rss version, it is

-unnecessary and potentially creates problems if you don’t preserve file

-modification times.

-3. If you are using an accelerator like php-apc you might need to

-restart apache if older cached versions of PHP files got stuck in cache

-(this happens rarely, but is a possibility).

+Alternatively, [install directly on a host machine](InstallationNotesHost).
\ No newline at end of file