forked from TYPO3/typo3
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.txt
257 lines (207 loc) · 9.97 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
*******************************************************************************
INSTALLING TYPO3
*******************************************************************************
This document is a part of the TYPO3 project. TYPO3 is an open source web
content management system released under the GNU GPL. TYPO3 is copyright
(c) 1999-2013 by Kasper Skaarhoj.
This document describes the system requirements for TYPO3 and the installation
routine.
===============================================================================
System requirements
===============================================================================
TYPO3 requires a web server with a PHP installation and a database. While TYPO3
can be configured to run on many web servers with different databases, this
document assumes that Apache and MySQL will be used. This document does not
cover using TYPO3 with other databases or web servers.
The following configuration is the minimum required:
- a web server capable of running PHP
- PHP 5.3.7 or newer with the following extensions:
- fileinfo
- filter
- GD2
- JSON
- mysqli
- openssl
- pcre
- session
- SOAP
- SPL
- standard
- xml
- zlib
- memory_limit set to at least 64M in php.ini
- register_globals is disabled in php.ini
- MySQL 5.0 or newer
- 200 MB of disk space
- AllowOverride in the Apache configuration includes "Indexes" and "FileInfo"
(see FAQ below)
- Apache stack size 8MB (or more). (see FAQ below)
The following configuration is recommended:
- Apache 2.x
- mod_expires and mod_rewrite enabled in the Apache configuration
- PHP 5.3.7 or newer with the following extensions:
- cURL
- fileinfo
- filter
- GD2
- hash
- JSON
- mbstring
- mysqli
- openssl
- pcre
- session
- SOAP
- SPL
- standard
- xml
- zlib
- Safe mode is not supported, thus it must not be activated
- Magic Quotes is deprecated, thus it should be deactivated
- memory_limit set to 128M or more in php.ini
- MySQL 5.1 or newer
- FreeType 2
- GraphicsMagick or ImageMagick v6 or newer
- 200 MB or more of disk space
- AllowOverride in the Apache configuration includes "Indexes" and "FileInfo"
(see FAQ below)
TYPO3 uses /dev/urandom or /dev/random on Unix-like platforms for security
purposes. Access to these files is highly recommended and increases TYPO3
security. Make sure to add "/dev/random:/dev/urandom" to open_basedir
settings if you use it. If these paths are unavailable, TYPO3 will attempt to
simulate random number generation. This is less secure, causes performance
issues and warnings in the TYPO3 system log.
TYPO3 relies on IPv6 support, which is by default enabled since PHP 5.3.
Take care not to compile PHP 5.3 with the option "--disable-ipv6", because
this will break the IPv6 support and the according unit tests.
===============================================================================
Obtaining TYPO3
===============================================================================
To get TYPO3, navigate to the following location:
http://typo3.org/download/
TYPO3 consists of two packages: source and dummy. The source package contains
files that are the same for every TYPO3 web site. The dummy package contains
files unique to each TYPO3 installation.
To install TYPO3, both packages must be downloaded.
===============================================================================
Installation: simple (not recommended!)
===============================================================================
This procedure is not recommended because it makes upgrades harder. However, it
can be the only option if you hosting company does not provide SSH access to
the web server.
To install TYPO3, unpack the source package locally. Unpacking will produce a
directory with a name like typo3_src-x.y.z, where x, y and z correspond to the
TYPO3 version. For example, the TYPO3 x.y.z source package will create a
directory named typo3_src-x.y.z.
Next unpack the dummy package. This will create a directory with the name
dummy-x.y.z. Now create a new directory and copy all files and folders from
within typo3_src-x.y.z and dummy-x.y.z into this new directory.
Use a FTP or SFTP program or any other available way to upload all files to
the web server.
Change permissions of the directories and files. The following directories and
files should be read-only for the web server:
typo3/
index.php
All other directories should be writable for the web server. If in doubt,
contact your hosting company and ask them to assist in adjusting permissions.
===============================================================================
Installation: recommended
===============================================================================
To install TYPO3, unpack the source package outside of the web site root
directory on your server. The location must be accessible to the web server.
Unpacking will produce a directory with a name like typo3_src-x.y.z, where x,
y and z correspond to the TYPO3 version. For example, the TYPO3 4.6.0 source
package will create a directory named typo3_src-4.6.0.
Unpack the dummy package in the temporary location on the server. This will
create a dummy-x.y.z directory. Move all files and directories from the
dummy-x.y.z directory to the web site root directory.
Linux, Unix and Mac OS X users should use the tar.gz packages and unpack them
using:
tar xzf source-x.y.z
tar xzf dummy-x.y.z
Windows users can use Windows built-in unpacker on unpack ZIP versions of
packages.
On Linux, Unix or Mac OS X systems create a symbolic link named typo3_src
pointing to the source package:
ln -s /var/www/typo3_src-4.6.0 /var/www/example.com/typo3_src
On Windows Vista or Windows 7 create a symbolic link named typo3_src
pointing to the source package:
mklink /D C:\<dir>\example.com\typo3_src C:\<dir>\typo3_src-4.6.0
Users of Windows XP/2000 or newer can use the "junction" program by
Marc Russinovich to create links. The program can be obtained at:
http://technet.microsoft.com/en-us/sysinternals/bb896768.aspx
Next create link for the typo3/ directory:
cd /var/www/example.com
ln -s typo3_src/typo3
Linux, Unix and Mac OS X users also create a symbolic link to index.php
ln -s typo3_src/index.php
Windows users must copy index.php from the source directory to the web site
root directory because Windows does not support links for files.
Change permissions and ownership of the directories. This usually requires the
"sudo" command. Assuming that the web server user is in the group named
"apache", execute the following commands in the web site root directory:
sudo chgrp -R apache fileadmin typo3temp typo3conf uploads
sudo chmod -R g+rwX,o-w fileadmin typo3temp typo3conf uploads
If "sudo" is not available, ask your hosting company to change the permissions.
===============================================================================
Setting up TYPO3
===============================================================================
To set up TYPO3, navigate to your web site. The TYPO3 installer will run in the
1-2-3 mode to easily guide you through the installation.
===============================================================================
Troubleshooting
===============================================================================
For troubleshooting read the FAQ below. If your problem is not listed, feel
free to ask questions in the TYPO3 mailing lists:
http://typo3.org/support/mailing-lists/
===============================================================================
FAQ
===============================================================================
Q: Why do I get "500 Server error" when I navigate to my TYPO3 web site
immediately after installation?
A: Make sure that AllowOverride allows "Indexes" and "FileInfo" in the Apache
configuration. If you cannot ensure this, rename .htaccess files to
_.htaccess. TYPO3 will run but considerably slower.
Here is the list of the files to rename:
typo3/contrib/.htaccess
typo3/gfx/.htaccess
typo3/mod/user/ws/.htaccess
typo3/sysext/.htaccess
typo3/sysext/t3skin/stylesheets/.htaccess
If the error does not disappear, web server error logs should help. For
Apache, the error log is usually located in /var/log/apache2 or
/var/log/httpd. Check with your hosting provider if you are in doubt where
the logs are located.
Q: Backend or Installer looks strange, no images just black and white?
A: Maybe you missed some configuration in your .htaccess file.
Have a look at typo3_src/misc/advanced.htaccess to find the options
you might need.
Q: I went through the setup process and created an admin user. Why can't I log
in now?
A: If you use MySQL 5.x or newer, try setting it to "compatible" mode. Open the
TYPO3 Install tool under http://example.com/typo3/install/ (where example.com
is the web site domain), navigate to "All configuration". find "setDBinit",
and add this line to the top of the input field:
SET SESSION sql_mode='MYSQL40'
Q: Some modules or extensions make Apache crash on Windows. What is the cause?
A: Fluid uses complex regular expressions which require a lot of stack space
during the first processing. On Windows the default stack size for Apache
is a lot smaller than on unix. You can increase the size to 8MB (default on
unix) by adding to the httpd.conf:
<IfModule mpm_winnt_module>
ThreadStackSize 8388608
</IfModule>
Restart Apache after this change.
Q: What do I have to do regarding security?
A: You have to make sure that you keep your TYPO3-core and the extensions
up to date.
* Subscribe to the announcement mailing list. This will inform you about new
releases of the TYPO3 core and security bulletins of core and community
extensions.
http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-announce
* Use the scheduler task "Update Extension List (em)" to update the list of
available extensions regularly. You should check regularly, if new versions
of these extensions are available and install them respectively.
* For further reading regarding securing TYPO3, please read the TYPO3 security
cookbook and other resources. Please visit
http://typo3.org/teams/security/resources/