Show More
@@ -1,109 +1,110 b'' | |||
|
1 | 1 | .. _quick-start: |
|
2 | 2 | |
|
3 | 3 | Quick Start Installation Guide |
|
4 | 4 | ============================== |
|
5 | 5 | |
|
6 | 6 | .. important:: |
|
7 | 7 | |
|
8 | 8 | These are quick start instructions. To optimize your |RCE|, |
|
9 | 9 | |RCC|, and |RCT| usage, read the more detailed instructions in our guides. |
|
10 | 10 | For detailed installation instructions, see |
|
11 | 11 | :ref:`RhodeCode Control Documentation <control:rcc>` |
|
12 | 12 | |
|
13 | 13 | .. tip:: |
|
14 | 14 | |
|
15 | 15 | If using a non-SQLite database, install and configure the database, create |
|
16 | 16 | a new user, and grant permissions. You will be prompted for this user's |
|
17 | 17 | credentials during |RCE| installation. See the relevant database |
|
18 | 18 | documentation for more details. |
|
19 | 19 | |
|
20 | 20 | To get |RCE| up and running, run through the below steps: |
|
21 | 21 | |
|
22 |
1. Download the latest |RCC| installer from |
|
|
23 | or main page. | |
|
22 | 1. Download the latest |RCC| installer from `rhodecode.com/download`_. | |
|
24 | 23 | If you don't have an account, sign up at `rhodecode.com/register`_. |
|
25 | 24 | |
|
26 | 25 | 2. Run the |RCC| installer and accept the End User Licence using the |
|
27 | 26 | following example: |
|
28 | 27 | |
|
29 | 28 | .. code-block:: bash |
|
30 | 29 | |
|
31 | 30 | $ chmod 755 RhodeCode-installer-linux-* |
|
32 | 31 | $ ./RhodeCode-installer-linux-* |
|
33 | 32 | |
|
34 | 33 | 3. Install a VCS Server, and configure it to start at boot. |
|
35 | 34 | |
|
36 | 35 | .. code-block:: bash |
|
37 | 36 | |
|
38 | 37 | $ rccontrol install VCSServer |
|
39 | 38 | |
|
40 | 39 | Agree to the licence agreement? [y/N]: y |
|
41 | 40 | IP to start the server on [127.0.0.1]: |
|
42 | 41 | Port for the server to start [10005]: |
|
43 | 42 | Creating new instance: vcsserver-1 |
|
44 | 43 | Installing RhodeCode VCSServer |
|
45 | 44 | Configuring RhodeCode VCS Server ... |
|
46 | 45 | Supervisord state is: RUNNING |
|
47 | 46 | Added process group vcsserver-1 |
|
48 | 47 | |
|
49 | 48 | |
|
50 | 49 | 4. Install |RCEE| or |RCCE|. If using MySQL or PostgreSQL, during |
|
51 | 50 | installation you'll be asked for your database credentials, so have them at hand. |
|
52 | 51 | Mysql or Postgres needs to be running and a new database needs to be created. |
|
53 | 52 | You don't need any credentials or to create a database for SQLite. |
|
54 | 53 | |
|
55 | 54 | .. code-block:: bash |
|
56 | 55 | :emphasize-lines: 11-16 |
|
57 | 56 | |
|
58 | 57 | $ rccontrol install Community |
|
59 | 58 | |
|
60 | 59 | or |
|
61 | 60 | |
|
62 | 61 | $ rccontrol install Enterprise |
|
63 | 62 | |
|
64 | 63 | Username [admin]: username |
|
65 | 64 | Password (min 6 chars): |
|
66 | 65 | Repeat for confirmation: |
|
67 | 66 | Email: your@mail.com |
|
68 | 67 | Respositories location [/home/brian/repos]: |
|
69 | 68 | IP to start the Enterprise server on [127.0.0.1]: |
|
70 | 69 | Port for the Enterprise server to use [10004]: |
|
71 | 70 | Database type - [s]qlite, [m]ysql, [p]ostresql: |
|
72 | 71 | PostgreSQL selected |
|
73 | 72 | Database host [127.0.0.1]: |
|
74 | 73 | Database port [5432]: |
|
75 | 74 | Database username: db-user-name |
|
76 | 75 | Database password: somepassword |
|
77 | 76 | Database name: example-db-name |
|
78 | 77 | |
|
79 | 78 | 5. Check the status of your installation. You |RCEE|/|RCCE| instance runs |
|
80 | 79 | on the URL displayed in the status message. |
|
81 | 80 | |
|
82 | 81 | .. code-block:: bash |
|
83 | 82 | |
|
84 | 83 | $ rccontrol status |
|
85 | 84 | |
|
86 | 85 | - NAME: enterprise-1 |
|
87 | 86 | - STATUS: RUNNING |
|
88 | 87 | - TYPE: Enterprise |
|
89 | 88 | - VERSION: 4.1.0 |
|
90 | 89 | - URL: http://127.0.0.1:10003 |
|
91 | 90 | |
|
92 | 91 | - NAME: vcsserver-1 |
|
93 | 92 | - STATUS: RUNNING |
|
94 | 93 | - TYPE: VCSServer |
|
95 | 94 | - VERSION: 4.1.0 |
|
96 | 95 | - URL: http://127.0.0.1:10001 |
|
97 | 96 | |
|
98 | 97 | .. note:: |
|
99 | 98 | |
|
100 | 99 | Recommended post quick start install instructions: |
|
101 | 100 | |
|
102 | 101 | * Read the documentation |
|
103 | 102 | * Carry out the :ref:`rhodecode-post-instal-ref` |
|
104 | 103 | * Set up :ref:`indexing-ref` |
|
105 | 104 | * Familiarise yourself with the :ref:`rhodecode-admin-ref` section. |
|
106 | 105 | |
|
107 | 106 | .. _rhodecode.com/download/: https://rhodecode.com/download/ |
|
108 | 107 | .. _rhodecode.com: https://rhodecode.com/ |
|
109 | 108 | .. _rhodecode.com/register: https://rhodecode.com/register/ |
|
109 | .. _rhodecode.com/download: https://rhodecode.com/download/ | |
|
110 |
General Comments 0
You need to be logged in to leave comments.
Login now