docs: removed mentions of Nix manager, replaced some occurences of legacy rccontrol mentions, reworked quickstart

docs/admin/system-overview.rst

@@ -1,172 +1,168 b''
 .. _system-overview-ref:
 
 System Overview
 ===============
 
 Latest Version
 --------------
 
 * |release| on Unix and Windows systems.
 
 System Architecture
 -------------------
 
 The following diagram shows a typical production architecture.
 
 .. image:: ../images/architecture-diagram.png
   :align: center
 
 Supported Operating Systems
 ---------------------------
 
 Linux
 ^^^^^
 
 * Ubuntu 14.04+
 * CentOS 6.2, 7 and 8
 * RHEL 6.2, 7 and 8
 * Debian 7.8
 * RedHat Fedora
 * Arch Linux
 * SUSE Linux
 
 Windows
 ^^^^^^^
 
 * Windows Vista Ultimate 64bit
 * Windows 7 Ultimate 64bit
 * Windows 8 Professional 64bit
 * Windows 8.1 Enterprise 64bit
 * Windows Server 2008 64bit
 * Windows Server 2008-R2 64bit
 * Windows Server 2012 64bit
 
 Supported Databases
 -------------------
 
 * SQLite
 * MySQL
 * MariaDB
 * PostgreSQL
 
 Supported Browsers
 ------------------
 
 * Chrome
 * Safari
 * Firefox
 * Internet Explorer 10 & 11
 
 System Requirements
 -------------------
 
 |RCE| performs best on machines with ultra-fast hard disks. Generally disk
 performance is more important than CPU performance. In a corporate production
 environment handling 1000s of users and |repos| you should deploy on a 12+
 core 64GB RAM server. In short, the more RAM the better.
 
 
 For example:
 
  - for team of 1 - 5 active users you can run on 1GB RAM machine with 1CPU
  - above 250 active users, |RCE| needs at least 8GB of memory.
    Number of CPUs is less important, but recommended to have at least 2-3 CPUs
 
 
 .. _config-rce-files:
 
 Configuration Files
 -------------------
 
 * :file:`config/_shared/rhodecode.ini`
 * :file:`/home/{user}/.rccontrol/{instance-id}/search_mapping.ini`
 * :file:`/home/{user}/.rccontrol/{vcsserver-id}/vcsserver.ini`
 * :file:`/home/{user}/.rccontrol/supervisor/supervisord.ini`
 * :file:`/home/{user}/.rccontrol.ini`
 * :file:`/home/{user}/.rhoderc`
 * :file:`/home/{user}/.rccontrol/cache/MANIFEST`
 
 For more information, see the :ref:`config-files` section.
 
 Log Files
 ---------
 
 * :file:`/home/{user}/.rccontrol/{instance-id}/enterprise.log`
 * :file:`/home/{user}/.rccontrol/{vcsserver-id}/vcsserver.log`
 * :file:`/home/{user}/.rccontrol/supervisor/supervisord.log`
 * :file:`/tmp/rccontrol.log`
 * :file:`/tmp/rhodecode_tools.log`
 
 Storage Files
 -------------
 
 * :file:`/home/{user}/.rccontrol/{instance-id}/data/index/{index-file.toc}`
 * :file:`/home/{user}/repos/.rc_gist_store`
 * :file:`/home/{user}/.rccontrol/{instance-id}/rhodecode.db`
 * :file:`/opt/rhodecode/store/{unique-hash}`
 
 Default Repositories Location
 -----------------------------
 
 * :file:`/home/{user}/repos`
 
 Connection Methods
 ------------------
 
 * HTTPS
 * SSH
 * |RCE| API
 
 Internationalization Support
 ----------------------------
 
 Currently available in the following languages, see `Transifex`_ for the
 latest details. If you want a new language added, please contact us. To
 configure your language settings, see the :ref:`set-lang` section.
 
 .. hlist::
 
   * Belorussian
   * Chinese
   * French
   * German
   * Italian
   * Japanese
   * Portuguese
   * Polish
   * Russian
   * Spanish
 
 Licencing Information
 ---------------------
 
 * See licencing information `here`_
 
 Peer-to-peer Failover Support
 -----------------------------
 
 * Yes
 
-Additional Binaries
--------------------
-
-* Yes, see :ref:`rhodecode-nix-ref` for full details.
 
 Remote Connectivity
 -------------------
 
 * Available
 
 Executable Files
 ----------------
 
 Windows: :file:`RhodeCode-installer-{version}.exe`
 
 Deprecated Support
 ------------------
 
 - Internet Explorer 8 support deprecated since version 3.7.0.
 - Internet Explorer 9 support deprecated since version 3.8.0.
 
 .. _here: https://rhodecode.com/licenses/
 .. _Transifex: https://explore.transifex.com/rhodecode/RhodeCode/

docs/contributing/dev-setup.rst

@@ -1,243 +1,13 b''
 .. _dev-setup:
 
 ===================
  Development setup
 ===================
 
-
-RhodeCode Enterprise runs inside a Nix managed environment. This ensures build
-environment dependencies are correctly declared and installed during setup.
-It also enables atomic upgrades, rollbacks, and multiple instances of RhodeCode
-Enterprise running with isolation.
-
-To set up RhodeCode Enterprise inside the Nix environment, use the following steps:
-
-
-
-Setup Nix Package Manager
--------------------------
-
-To install the Nix Package Manager, please run::
-
-   $ curl https://releases.nixos.org/nix/nix-2.3.4/install | sh
-
-or go to https://nixos.org/nix/ and follow the installation instructions.
-Once this is correctly set up on your system, you should be able to use the
-following commands:
-
-* `nix-env`
-
-* `nix-shell`
-
-
-.. tip::
-
-   Update your channels frequently by running ``nix-channel --update``.
-
-.. note::
-
-   To uninstall nix run the following:
-
-    remove the . "$HOME/.nix-profile/etc/profile.d/nix.sh" line in your ~/.profile or ~/.bash_profile
-    rm -rf $HOME/{.nix-channels,.nix-defexpr,.nix-profile,.config/nixpkgs}
-    sudo rm -rf /nix
-
-Switch nix to the latest STABLE channel
----------------------------------------
-
-run::
-
-   nix-channel --add https://nixos.org/channels/nixos-20.03 nixpkgs
-
-Followed by::
-
-   nix-channel --update
-   nix-env -i nix-2.3.4
-
-
-Install required binaries
--------------------------
-
-We need some handy tools first.
-
-run::
-
-    nix-env -i nix-prefetch-hg
-    nix-env -i nix-prefetch-git
-
-
-Speed up JS build by installing PhantomJS
------------------------------------------
-
-PhantomJS will be downloaded each time nix-shell is invoked. To speed this by
-setting already downloaded version do this::
-
-    nix-env -i phantomjs-2.1.1
-
-    # and set nix bin path
-    export PATH=$PATH:~/.nix-profile/bin
-
-
-Clone the required repositories
--------------------------------
-
-After Nix is set up, clone the RhodeCode Enterprise Community Edition and
-RhodeCode VCSServer repositories into the same directory.
-RhodeCode currently is using Mercurial Version Control System, please make sure
-you have it installed before continuing.
-
-To obtain the required sources, use the following commands::
-
-    mkdir rhodecode-develop && cd rhodecode-develop
-    hg clone -u default https://code.rhodecode.com/rhodecode-enterprise-ce
-    hg clone -u default https://code.rhodecode.com/rhodecode-vcsserver
-
-.. note::
-
-   If you cannot clone the repository, please contact us via [e-mail]
-
-
-Install some required libraries
--------------------------------
-
-There are some required drivers and dev libraries that we need to install to
-test RhodeCode under different types of databases. For example in Ubuntu we
-need to install the following.
-
-required libraries::
-
-    # svn related
-    sudo apt-get install libapr1-dev libaprutil1-dev
-    sudo apt-get install libsvn-dev
-    # libcurl required too
-    sudo apt-get install libcurl4-openssl-dev
-    # mysql/pg server for development, optional
-    sudo apt-get install mysql-server libmysqlclient-dev
-    sudo apt-get install postgresql postgresql-contrib libpq-dev
-
-
-
-Enter the Development Shell
----------------------------
-
-The final step is to start the development shells. To do this, run the
-following command from inside the cloned repository::
-
-   # first, the vcsserver
-   cd ~/rhodecode-vcsserver
-   nix-shell
-
-   # then enterprise sources
-   cd ~/rhodecode-enterprise-ce
-   nix-shell
-
-.. note::
-
-   On the first run, this will take a while to download and optionally compile
-   a few things. The following runs will be faster. The development shell works
-   fine on both MacOS and Linux platforms.
-
-
-Create config.nix for development
----------------------------------
-
-In order to run proper tests and setup linking across projects, a config.nix
-file needs to be setup::
-
-    # create config
-    mkdir -p ~/.nixpkgs
-    touch ~/.nixpkgs/config.nix
-
-    # put the below content into the ~/.nixpkgs/config.nix file
-    # adjusts, the path to where you cloned your repositories.
-
-    {
-      rc = {
-       sources = {
-        rhodecode-vcsserver = "/home/dev/rhodecode-vcsserver";
-        rhodecode-enterprise-ce = "/home/dev/rhodecode-enterprise-ce";
-        rhodecode-enterprise-ee = "/home/dev/rhodecode-enterprise-ee";
-       };
-      };
-    }
-
-
-
-Creating a Development Configuration
-------------------------------------
-
-To create a development environment for RhodeCode Enterprise,
-use the following steps:
-
-1. Create a copy of vcsserver config:
-    `cp ~/rhodecode-vcsserver/configs/development.ini ~/rhodecode-vcsserver/configs/dev.ini`
-2. Create a copy of rhodocode config:
-    `cp ~/rhodecode-enterprise-ce/configs/development.ini ~/rhodecode-enterprise-ce/configs/dev.ini`
-3. Adjust the configuration settings to your needs if needed.
-
-.. note::
-
-  It is recommended to use the name `dev.ini` since it's included in .hgignore file.
-
-
-Setup the Development Database
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To create a development database, use the following example. This is a one
-time operation executed from the nix-shell of rhodecode-enterprise-ce sources ::
-
-    rc-setup-app dev.ini \
-        --user=admin --password=secret \
-        --email=[e-mail] \
-        --repos=~/my_dev_repos
-
-
-Compile CSS and JavaScript
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To use the application's frontend and prepare it for production deployment,
-you will need to compile the CSS and JavaScript with Grunt.
-This is easily done from within the nix-shell using the following command::
-
-    make web-build
-
-When developing new features you will need to recompile following any
-changes made to the CSS or JavaScript files when developing the code::
-
-    grunt watch
-
-This prepares the development (with comments/whitespace) versions of files.
-
-Start the Development Servers
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-From the rhodecode-vcsserver directory, start the development server in another
-nix-shell, using the following command::
-
-      pserve configs/dev.ini
-
-In the adjacent nix-shell which you created for your development server, you may
-now start CE with the following command::
-
-
-      pserve --reload configs/dev.ini
-
-.. note::
-
-  `--reload` flag will automatically reload the server when source file changes.
-
-
-Run the Environment Tests
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Please make sure that the tests are passing to verify that your environment is
-set up correctly. RhodeCode uses py.test to run tests.
-While your instance is running, start a new nix-shell and simply run
-``make test`` to run the basic test suite.
-
+#TODO
 
 Need Help?
 ^^^^^^^^^^
 
 Join us on Slack via https://rhodecode.com/join or post questions in our
 Community Portal at https://community.rhodecode.com

docs/index.rst

@@ -1,93 +1,92 b''
 |RCE|
 =====
 
 |RCE| is a high-performance source code management and collaboration system.
 It enables you to develop projects securely behind the firewall while
 providing collaboration tools that work with |git|, |hg|,
 and |svn| |repos|. The user interface allows you to create, edit,
 and commit files and |repos| while managing their security permissions.
 
 |RCE| provides the following features:
 
 * Source code management.
 * Extended permissions management.
 * Integrated code collaboration tools.
 * Integrated code review and notifications.
 * Scalability provided by multi-node setup.
 * Fully programmable automation API.
 * Web-based hook management.
 * Native |svn| support.
 * Migration from existing databases.
 * |RCE| SDK.
 * Built-in analytics
 * Built in integrations including: Slack, Webhooks (used for Jenkins/TeamCity and other CIs), Jira, Redmine, Hipchat
 * Pluggable authentication system.
 * Support for AD, |LDAP|, Crowd, CAS, PAM.
 * Support for external authentication via Oauth Google, Github, Bitbucket, Twitter.
 * Debug modes of operation.
 * Private and public gists.
 * Gists with limited lifetimes and within instance only sharing.
 * Fully integrated code search function.
 * Always on SSL connectivity.
 
 .. only:: html
 
    Table of Contents
    -----------------
 
 .. toctree::
    :maxdepth: 1
    :caption: Admin Documentation
 
    install/quick-start
    install/install-database
    install/install-steps
    admin/system-overview
-   nix/default-env
    admin/system-admin
    admin/user-admin
    admin/repo-admin
    admin/security-tips
    auth/auth
    issue-trackers/issue-trackers
    admin/lab-settings
 
 .. toctree::
    :maxdepth: 1
    :caption: Feature Documentation
 
    collaboration/collaboration
    collaboration/review-notifications
    collaboration/pull-requests
    code-review/code-review
    integrations/integrations
 
 .. toctree::
    :maxdepth: 1
    :caption: User Documentation
 
    usage/basic-usage
    tutorials/tutorials
 
 .. toctree::
    :maxdepth: 1
    :caption: Developer Documentation
 
    api/api
    tools/rhodecode-tools
    extensions/extensions-hooks
    contributing/contributing
 
 .. toctree::
    :maxdepth: 2
-   :caption: RhodeCode Control Documentation
+   :caption: RhodeCode RCstack Documentation
 
-   RhodeCode Installer <https://docs.rhodecode.com/RhodeCode-Control/>
+   RhodeCode RCstack Installer <https://docs.rhodecode.com/rcstack/>
 
 .. toctree::
    :maxdepth: 1
    :caption: About
 
    known-issues/known-issues
    release-notes/release-notes
    admin/glossary

docs/install/quick-start.rst

@@ -1,121 +1,24 b''
 .. _quick-start:
 
 Quick Start Installation Guide
 ==============================
 
-.. important::
-
-    These are quick start instructions. To optimize your |RCE|,
-    |RCC|, and |RCT| usage, read the more detailed instructions in our guides.
-    For detailed installation instructions, see
-    :ref:`RhodeCode Control Documentation <control:rcc>`
-
-.. tip::
-
-   If using a non-SQLite database, install and configure the database, create
-   a new user, and grant permissions. You will be prompted for this user's
-   credentials during |RCE| installation. See the relevant database
-   documentation for more details.
-
-To get |RCE| up and running, run through the below steps:
-
-1. Download the latest |RCC| installer from `rhodecode.com/download`_.
-   If you don't have an account, sign up at `rhodecode.com/register`_.
-
-2. Run the |RCC| installer and accept the End User Licence using the
-   following example:
-
-.. code-block:: bash
-
-    $ chmod +x RhodeCode-installer-linux-*
-    $ ./RhodeCode-installer-linux-*
-
-    Do you accept the RhodeCode Control license?
-    Press [Y] to accept license and [V] to view license text: y
-
-
-.. important::
-
-   We recommend running RhodeCode as a non-root user, such as `rhodecode`;
-   this user must have a proper home directory.
-   Either log in as that user to install the software, or do it as root
-   with `sudo -i -u rhodecode ./RhodeCode-installer-linux-*`
-
-
-3. Install a VCS Server, and configure it to start at boot.
-
-.. code-block:: bash
-
-    $ rccontrol install VCSServer
+Since version 5.0.0 Rhodecode runs in Docker, and to get |RCE| up and running,
+you need to use RCstack installer - <https://docs.rhodecode.com/rcstack/install/installation.html/>
 
-    Agree to the licence agreement? [y/N]: y
-    IP to start the server on [127.0.0.1]:
-    Port for the server to start [10005]:
-    Creating new instance: vcsserver-1
-    Installing RhodeCode VCSServer
-    Configuring RhodeCode VCS Server ...
-    Supervisord state is: RUNNING
-    Added process group vcsserver-1
-
-
-4. Install |RCEE| or |RCCE|. If using MySQL or PostgreSQL, during
-   installation you'll be asked for your database credentials, so have them at hand.
-   Mysql or Postgres needs to be running and a new database needs to be created.
-   You don't need any credentials or to create a database for SQLite.
-
-.. code-block:: bash
-   :emphasize-lines: 11-16
-
-    $ rccontrol install Community
-
-    or
-
-    $ rccontrol install Enterprise
+Please refer to RCstack documentation for
 
-    Username [admin]: username
-    Password (min 6 chars):
-    Repeat for confirmation:
-    Email: [e-mail]
-    Respositories location [/home/brian/repos]:
-    IP to start the Enterprise server on [127.0.0.1]:
-    Port for the Enterprise server to use [10004]:
-    Database type - [s]qlite, [m]ysql, [p]ostresql:
-    PostgreSQL selected
-    Database host [127.0.0.1]:
-    Database port [5432]:
-    Database username: db-user-name
-    Database password: somepassword
-    Database name: example-db-name
-
-5. Check the status of your installation. You |RCEE|/|RCCE| instance runs
-   on the URL displayed in the status message.
-
-.. code-block:: bash
-
-    $ rccontrol status
-
-    - NAME: enterprise-1
-    - STATUS: RUNNING
-    - TYPE: Enterprise
-    - VERSION: 4.1.0
-    - URL: http://127.0.0.1:10003
-
-    - NAME: vcsserver-1
-    - STATUS: RUNNING
-    - TYPE: VCSServer
-    - VERSION: 4.1.0
-    - URL: http://127.0.0.1:10001
 
 .. note::
 
    Recommended post quick start install instructions:
 
    * Read the documentation
    * Carry out the :ref:`rhodecode-post-instal-ref`
    * Set up :ref:`indexing-ref`
    * Familiarise yourself with the :ref:`rhodecode-admin-ref` section.
 
 .. _rhodecode.com: https://rhodecode.com/
 .. _rhodecode.com/register: https://rhodecode.com/register/
 .. _rhodecode.com/download: https://rhodecode.com/download/