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