- 1 Description
- 2 Dependencies
- 3 Creation
- 4 Moderation
- 5 How to configure it
- 6 How to use it
- 7 Tips and tricks
- 8 Compatibility with some third party applications
- 9 Useful Links
A Website allows you to put some web pages online (surprising eh ?). You can use almost all php softwares but also static pages.
All, php5, Perl, python, ruby by default; ask if you need another one, as well as if you need a module. But don't expect neither mod_php, nor mod_python, nor mod_perl, nor RoR (not yet for this one, see below !).
About PHP configuration:
As usual, you will have to login on the panel. Select the project which need a website and use the "create" link in the website menu. Fill up the form, submit it and wait for moderation.
Trick and tips
- Be careful when asking for a website, specially when filling up the "name" field (see next section for more informations)
- Don't forget to fill up the description. This description will be displayed on the list of all hosted websites so take the time to write a nice description (don't forget the license!)
Choosing the website name
You have two options :
If you own a domain
If you own a domain (mydomain.org for example): then you might want to create a website www.mydomain.org or wiki.mydomain.org. In ANY case, do NOT put "www" in the servername field: just ask for a website named mydomain.org or wiki.mydomain.org. The panel is smart enough, it will redirect www.mydomain.com to the website named mydomain.com.
TuxFamily does not sell domain names, so make sure that the domain is yours before asking a website. If you want a domain, you can buy one here for example.
Of course, don't forget to create an alias on your domain configuration page (www.mydomain.org and mydomain.org => web.tuxfamily.net. (188.8.131.52) ) otherwise, it won't work...
You can also, if you want, host your DNS on TuxFamily, isn't life nice ? :D
If you don't have a domain
If you don't have a domain, you will have to ask for a *.tuxfamily.org website. If you want mywebsite.tuxfamily.org, ask for a web space named "mywebsite.tuxfamily.org" again, no www !
This object is moderated, see the moderation section
How to configure it
Use the panel to access the website configuration page. You can change the description. In this section, you will also find a link to your website's statistics.
How to play with handlers
On TuxFamily, you can play with the handlers to modify how scripts are executed
The handlers are configured as follows:
Name of handler Interpreter Associated extensions x-httpd-php4 /usr/bin/php4-cgi .php4 x-httpd-php5 /usr/bin/php5-cgi .php .php3 .php5 .phtml x-httpd-perl /usr/bin/perl .pl x-httpd-python /usr/bin/python .py x-httpd-bash /bin/bash .sh x-httpd-ruby /usr/bin/ruby .rb x-httpd-eruby /usr/bin/eruby .rhtml x-httpd-self self execution .cgi (using the script shebang)
How can I execute my perl through shebang? (example)
Please edit/add a .htaccess file and add:
AddHandler x-httpd-self .pl AddType application/x-httpd-self .pl
How to fallback to PHP4
This should only be used as a temporary solution. This feature will be available until the upgrade to Debian lenny, which abandoned PHP4 support. This is a good opportunity to upgrade your CMS/wiki/... !
- By .htaccess file
If you want all your .php files to be read in as php4 scripts, you simply have to create a .htaccess file in your folder which includes the following lines :
AddHandler x-httpd-php4 .php AddType application/x-httpd-php4 .php
- By extension
By default, scripts with a .php and .php5 extension will be run as php4 scripts. Scripts with a .php4 extension will be run as php4 scripts.
How to manage permissions
There are two levels of permissions:
- the access to the website configuration using ACL
- the access to the files files of the website using the unix permissions(en)
How to delete it
- Log in on the panel
- click on the group of your project
- click on your website
- click on delete
How to use it
How do I upload files on my website ?
- the files are to be uploaded in the htdocs/ folder in your website folder on the FTP server (ftp.tuxfamily.org), SFTP server (sftp.tuxfamily.org), SSH server ( ssh.tuxfamily.org ). Your user name and password are the one you use to log on the panel. Also, you must activate a shell on your account before using SFTP or SSH.
Imagine you have a group 'toto' and the website toto.tuxfamily.org, the files must be uploaded into toto/toto.tuxfamily.org-web/htdocs/ on the FTP.
- The folder of the website is in the your group's folder (which is in your starting folder on the FTP). It ends with the suffix "-web".
- the tmp/ folder is used for temporary files of PHP as well as sessions.
- DO NOT put your PHP scripts or ANY files in chmod 777. They won't execute anyway and it is a serious security issue!
- the statistics of your website are available on http://stats.tuxfamily.org/YOURWEBSITE/. For example: http://stats.tuxfamily.org/faq.tuxfamily.org/
- if you get a 500 error:
"Internal Server Error The server encountered an internal error or misconfiguration and was unable to complete your request."
This may be due to a bad rights on your files: their writing right must NOT be 'other' (safety measure). You may do a chmod 775 on these files.
Please check also your .htaccess file, you are not able to use php flags on TuxFamily without having an Internal server error.
If you have a group with more than one contributor, please make sure that each person register on the panel to get a login. Then, just add them in your group and they will be able to upload files by ftp, using their own password.
Make sure that your FTP client handle symbolic links otherwise you won't be able to browse your projects. Of course, do not delete those symbolic links!
Copy files to download repository
You can access to your download repository from the web servers in the folder /data/repository, /data/repository/vhffs4 for the vhffs4 group for example.
However, you must not access this folder very often, it only needs to be used to upload file from the web service to your download repository, you should not read files on these repository and above all you must really not even consider one second to list the content of the folders. In other word, you should keep an index of uploaded files and provide URLs that look like http://download.tuxfamily.org/.../ to your visitors.
Tips and tricks
- You HAVE TO upgrade the webapps you are using (wiki, CMS, blog, ...) in order to fix their numerous security issues. This is mandatory, we require that you do that. Not doing that (voluntarily or not) is considered disrespectful.
- Do NOT put a 777 mode on one of yours php files. you can have security issues and it won't be loaded by our servers!
- For a same project, you can have more than one website, for example, you can have a wiki and a forum and a support site... like:
- If you just deleted your htdocs folder, come on our irc channel, an admin may be able to do something for you.
- If you can't upload your files without error, you need more disk-space. Try sending a mail to the staff to get your quota enlarged :)
- If you can't connect to our server, try using the passive mode (both work if your equipments are correctly configured on your side).
- If you have troubles removing a directory, you may have some "hidden" files. Make sure that your ftp client display them.
- If you want to use mod_rewrite in a .htaccess, start your .htaccess with:
RewriteEngine On RewriteBase /path/to/your/software ( ex: / if rules are applied on the root of your website, /forum , /wiki , ... in other cases )
- Promote TuxFamily with a link.
Compatibility with some third party applications
You'll find here a list of common problems reported by TuxFamily members with a page describing how to solve the problem when this is possible.