You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* add screenshots from Ubuntu config process
* add instructions for updating predeployed VMs
* add details on configuring mail server
* don't install test gems into prod
* no need for bundle exec
* small cleanups
Copy file name to clipboardExpand all lines: docs/INSTALL-ubuntu.md
+38-11Lines changed: 38 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,15 +2,37 @@
2
2
3
3
## Install Ubuntu 12.04 with the package groups:
4
4
5
+

6
+
5
7
* Basic ubuntu server
6
8
* OpenSSH server
7
9
* Mail server
8
10
* PostgreSQL database (9.1+)
9
11
12
+
You may be working on an already-installed or automatically deployed system, in which case you can install them afterwards:
13
+
14
+
# Run these commands as your normal login (e.g. "michael")
15
+
sudo apt-get update && sudo apt-get -y upgrade
16
+
sudo tasksel install openssh-server
17
+
sudo tasksel install mail-server
18
+
sudo tasksel install postgresql-server
19
+
10
20
### Configure the mail server:
11
21
22
+

23
+
12
24
In our example setup, we're going to configure as a 'Satellite system', forwarding all mail to our egress servers for delivery. You'll probably want to do that unless you're handling mail on the same machine as the Discourse software.
13
25
26
+

27
+
28
+
You probably want to configure your 'mail name' to be the base name of your domain. Note that this does not affect any email sent out by Discourse itself, just unqualified mail generated by systems programs.
29
+
30
+

31
+
32
+
If you have a mail server responsible for handling the egress of email from your network, enter it here. Otherwise, leave it blank.
33
+
34
+
## Additional system packages
35
+
14
36
Install necessary packages:
15
37
16
38
# Run these commands as your normal login (e.g. "michael")
@@ -139,9 +161,15 @@ Change to the 'discourse' user:
139
161
140
162
Install RVM if doing a single-user RVM installation:
# rvm added shell initialization code to ~/.bash_profile,
170
+
# move it to ~/.profile instead
171
+
cat ~/.bash_profile >> ~/.profile
172
+
rm ~/.bash_profile
145
173
146
174
# Install necessary packages for building ruby
147
175
rvm requirements
@@ -163,9 +191,9 @@ Continue with discourse installation
163
191
git checkout latest-release
164
192
165
193
# Install necessary gems
166
-
bundle install --deployment
194
+
bundle install --deployment --without test
167
195
168
-
_If you have errors building the native extensions, ensure you have sufficient free system memory. 1GB with no swap won't cut it._
196
+
_If you have errors building the native extensions, ensure you have sufficient free system memory. 1GB with no swap isn't enough, we recommend having 2GB as a minimum._
169
197
170
198
Configure discourse:
171
199
@@ -209,8 +237,8 @@ Initialize the database:
209
237
# Run these commands as the discourse user
210
238
# The database name here should match the production one in database.yml
0 commit comments