- 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
A Website allows you to put some web pages online (surprising eh ?). You can use almost all php softwares but also static pages.
All, php7, php5, Perl, python, ruby by default; ask if you need another one, as well as if you need a module. But don't expect either mod_php, nor mod_python, nor mod_perl, nor RoR (not yet for this one, see below !).
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 projects 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 alias 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. (18.104.22.168 / 2a02:2178:1000:201::4) ) otherwise, it won't work...
You can also, if you want, host your DNS on TuxFamily, isn't life nice ? :D
If you already have a site accessible by an project.tuxfamily.org address type and you want to migrate to an project.org address type, then you may be interested in this page: How to change from project.tuxfamily.org to project.org address?
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 !
Warning: You can ask for mywebsite.tuxfamily.org and forum.mywebsite.tuxfamily.org but you can't for mywebsite.forum.tuxfamily.org.
forum.tuxfamily.org already exists for TuxFamily and all the *.forum.tuxfamily.org are reserved. It's the same for all the urls of TuxFamily like forum, faq, projects or panel. More generally, when you ask for foo.bar.tuxfamily.org be sure that bar doesn't belong to anybody (or is yours). When in doubt, search for bar on the projects page.
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.
How to play with types and handlers
On TuxFamily, you can play with the types and handlers to modify how scripts are executed
The handlers are configured as follows:
Name of MIME type Interpreter Associated extensions application/x-httpd-php5 /usr/bin/php5-cgi .php .php3 .php4 .php5 .phtml application/x-httpd-php7 /usr/bin/php-cgi7.3 .php7 application/x-httpd-perl /usr/bin/perl .pl application/x-httpd-python /usr/bin/python .py application/x-httpd-bash /bin/bash .sh application/x-httpd-ruby /usr/bin/ruby .rb application/x-httpd-eruby /usr/bin/eruby .rhtml application/x-httpd-scheme /usr/bin/csi .scm .ss application/x-httpd-self self execution .cgi (using the script shebang)
In order to execute PHP7 instead of PHP5, edit/add a .htaccess file and add:
AddType application/x-httpd-php7 .php
How can I execute my perl through shebang? (example)
Please edit/add a .htaccess file and add:
AddType application/x-httpd-self .pl
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):
$ ssh firstname.lastname@example.org "chmod 755 group group/webarea.tuxfamily.org-web \ group/webarea.tuxfamily.org-web/htdocs"
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 'group' and the website webarea.tuxfamily.org, the files must be uploaded into group/webarea.tuxfamily.org-web/htdocs/ on the FTP, that can be accessed by rsync over SSH:
$ rsync -av ./webarea/ email@example.com:group/webarea.tuxfamily.org-web/htdocs/
- 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/
- for this purpose, we use awstats; we hope that you'll like it.
- 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.
How to enable TLS/HTTPS?
You do not need to do anything, TLS certificates are generated once a day during the night through Let's Encrypt so during the first day you will not have a dedicated TLS certificate.
Once the certificate has been automatically generated you will see in the Web area administration:
TLS state Global state: Valid Expire: 10/12/2018 03:30:29 AM Retries: 0 Domain list: www.forum.tuxfamily.org forum.tuxfamily.org
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.