Difference between revisions of "WebArea/En"

From TuxFamilyFAQ
Jump to navigationJump to search
(Add link to Compat/PHP.)
 
(84 intermediate revisions by 17 users not shown)
Line 2: Line 2:
  
 
{{Template:Languages}}
 
{{Template:Languages}}
{{Template:Incomplete|En}}
 
  
 
= Description =
 
= Description =
Line 8: Line 7:
 
A Website allows you to put some web pages online (surprising eh ?).
 
A Website allows you to put some web pages online (surprising eh ?).
 
You can use almost all php softwares but also static pages.
 
You can use almost all php softwares but also static pages.
We provide Php4 AND php5 (see the configuration section of this page for more informations)
 
  
= Dependences =
+
== Supported languages ==
 +
 
 +
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 !).
 +
 
 +
About PHP configuration: http://hack.tuxfamily.org/phpinfo.php7 and http://hack.tuxfamily.org/phpinfo.php
 +
 
 +
= Dependencies =
  
 
*An [[User/En|account]]
 
*An [[User/En|account]]
Line 23: Line 27:
  
 
*Be careful when asking for a website, specially when filling up the "name" field (see next section for more informations)
 
*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 [https://panel.tuxfamily.org/public/allwebsites.pl list of all hosted websites] so take the time to write a nice description (don't forget the license!)
+
*Don't forget to fill up the description. This description will be displayed on the [http://projects.tuxfamily.org/allgroups.pl list of all hosted projects] so take the time to write a nice description (don't forget the license!)
  
 
==Choosing the website name==
 
==Choosing the website name==
Line 31: Line 35:
 
===If you own a domain===
 
===If you own a domain===
  
If you own a [http://en.wikipedia.org/wiki/DNS domain] (mydomain.com for example): then you might want to create a website www.mydomain.com or wiki.mydomain.com.  
+
If you own a [http://en.wikipedia.org/wiki/DNS 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.com or wiki.mydomain.com. The panel is smart enough, it will redirect www.mydomain.com to the website named mydomain.com.  
+
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 do 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 [www.gandi.net here].  
+
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 [http://www.gandi.net here] for example.  
  
Of course, don't forget to create alias on your domain configuration page (www.mydomain.org => web.tuxfamily.net and mydomain.org => web.tuxfamily.net) otherwise, it won't work...
+
Of course, don't forget to create an alias on your domain configuration page (www.mydomain.org and mydomain.org => web.tuxfamily.net. (212.85.158.4 / 2a02:2178:1000:201::4) ) otherwise, it won't work...
  
You can also, if you want, host your [[DNS/En|DNS] on TuxFamily.
+
You can also, if you want, host your [[DNS/En|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: [[MigrationDomainName/En | 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===
  
 
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 !
 
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 [http://projects.tuxfamily.org/ the projects page].
  
 
= Moderation =
 
= Moderation =
Line 48: Line 58:
 
This object is moderated, see the [[Moderation/En|moderation section]]
 
This object is moderated, see the [[Moderation/En|moderation section]]
  
= Comment l'administrer (panel) =
+
= 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)
 +
 
 +
=== PHP7 ===
 +
 
 +
In order to execute PHP7 instead of PHP5, edit/add a .htaccess file and add:
 +
 
 +
AddType application/x-httpd-php7 .php
 +
 
 +
=== Self-execution ===
 +
 
 +
How can I execute my perl through shebang? (example)
  
Dans le panel, en cliquant sur votre site web,
+
Please edit/add a .htaccess file and add:
Vous pouvez activer le crawl sur votre site web pour faciliter leur indexation par les moteurs de recherche
 
Vous pouvez modifier la description du site.
 
Cliquez sur le lien statistiques pour savoir si votre site est visité et si oui par qui.
 
  
== Configuration ==
+
AddType application/x-httpd-self .pl
  
Comment fonctionnent PHP4 et PHP5 ?
+
== How to manage permissions ==
Il y a deux manières de faire fonctionner PHP5 sur Tuxfamily.
 
  
*Par extension
+
There are two levels of permissions:
Les scripts ayant l'extension .php seront éxécutés comme script PHP4. Les scripts ayant l'extension .php5 seront exécutés comme script PHP5.
 
  
*Par fichier .htaccess
+
* the access to the website configuration using [[Acl/Fr|ACL]]
Si vous souhaitez que tous les fichiers .php d'un repertoire soient interprété en php5, il suffit de placer un fichier .htaccess dans votre répertoire.
+
* the access to the files files of the website using the [http://en.wikipedia.org/wiki/Unix_permission#Traditional_Unix_permissions unix permissions(en)]:
Ce fichier doit contenir ces lignes:
+
$ ssh user@ssh.tuxfamily.org "chmod 755 group group/webarea.tuxfamily.org-web \
 +
    group/webarea.tuxfamily.org-web/htdocs"
  
AddHandler x-httpd-php5 .php
+
== How to delete it ==
AddType application/x-httpd-php5 .php
 
  
== Comment gerer les droits de mon groupe ==
+
* Log in on the panel
 +
* click on the group of your project
 +
* click on your website
 +
* click on delete
  
Il faut distinguer deux niveau:
+
= How to use it =
  
*l'accès à la configuration du site web en utilisant les [[Acl/Fr|ACL]]
+
== How do I upload files on my website ? ==
*l'accès aux fichiers du site en utilisant les [http://fr.wikipedia.org/wiki/Permissions_Unix permissions unix]
 
  
== Comment le détruire ==
+
* 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 [[User/En#SSH_access|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/ user@ssh.tuxfamily.org: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/En|awstats]]; we hope that you'll like it.
 +
* if you get a 500 error:
  
*loggez vous sur le panel
+
"Internal Server Error The server encountered an internal error or misconfiguration and was unable to complete          your request."
*cliquez sur le groupe de votre projet
 
*cliquez sur votre site web
 
*cliquez sur détruire
 
  
= Comment l'utiliser =
+
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.
  
*Les fichiers sont à déposer dans le répertoire htdocs/ sur le FTP (Serveur FTP : ftp.tuxfamily.org) dans le répertoire du site web.
+
Please check also your .htaccess file, you are not able to use php flags on TuxFamily without having an Internal server error.
Imaginons que vous ayez un groupe toto et un site web toto.tuxfamily.org, les fichiers seront à déposer dans toto/toto.tuxfamily.org-web/htdocs/ sur le FTP.
 
*Le répertoire du site web est dans le répertoire de votre groupe (qui lui, se trouve dans votre répertoire de démarrage sur le FTP). Il se termine par le suffixe "-web".
 
*Le répertoire tmp/ sert aux fichiers temporaires de PHP ainsi qu'aux sessions.
 
* Ne PAS mettre vos scripts PHP et TOUT FICHIER en chmod 777. Ils ne s'exécuteront pas de toute manière et cela est un grave problème de sécurité !
 
* Les statistiques de votre site sont disponibles sur http://stats.tuxfamily.org/VOTRESITE/. Par exemple: http://stats.tuxfamily.org/faq.tuxfamily.org/
 
* si vous obtenez une erreur 500:
 
  
 +
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.
  
"Internal Server Error
+
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!
  
The server encountered an internal error or misconfiguration and was
+
== Copy files to download repository ==
unable to complete your request."
+
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.
  
Ceci peut être du à un probleme de droits sur vos fichiers. En effet, other ne doit pas avoir le droit d'ecriture sur vos fichiers (par soucis de sécurite). Pensez à faire un chmod 775 sur vos fichiers.
+
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.
  
== Comment déposer mes fichiers sur mon site web ? ==
+
== How to enable TLS/HTTPS? ==
Une fois que vous avez demandé l'hébergement d'un site web et que celui-ci a été accepté, vous devez déposer vos fichiers dans le répertoire htdocs/ du site disponible dans le répertoire du groupe. Si vous avez un groupe projet avec plusieurs contributeurs, chacun se loggue par ftp avec son propre login.
 
  
Il vous faudra utiliser un client FTP gérant les liens symboliques sans quoi vous ne pourrez vous déplacer dans vos projets. Bien entendu, il ne faut pas supprimer ces liens...
+
You do not need to do anything, TLS certificates are generated once a day during the night through [https://letsencrypt.org/ Let's Encrypt] so during the first day you will not have a dedicated TLS certificate.
  
=Pourquoi TuxFamily ne fournit "que" php et pas python, perl whatever=
+
Once the certificate has been automatically generated you will see in the Web area administration:
  
Eh oui pour l'instant chez TuxFamily c'est php only! (ouah ça rime en plus :P)
+
TLS state
 +
Global state: Valid
 +
 +
Expire: 10/12/2018 03:30:29 AM
 +
 +
Retries: 0
 +
 +
Domain list: www.forum.tuxfamily.org forum.tuxfamily.org
  
Pour plus d'informations sur les versions de PHP:
+
= Tips and tricks =
*http://hack.tuxfamily.org/phpinfo.php pour PHP4
 
*http://hack.tuxfamily.org/phpinfo.php5 pour PHP5
 
  
 +
*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.
  
== Sécurité ==
+
*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!
Php, contrairement à Python, Perl, RoR,... dispose de mécanismes de sécurité intégrés (suphp, safe_mode,...) qui permettent :
 
*d'empêcher l'accès à la racine du serveur
 
*d'empêcher l'accès aux données des autres utilisateurs
 
*de faire tourner les scripts en tant qu'utilisateur
 
*d'empêcher d'écrire dans l'arborescence d'un autre utilisateur
 
*...
 
Tant que les autres langages ne proposeront pas les même possibilités en terme de sécurité, nous ne pourrons pas nous permettre de les mettre sur la plateforme.
 
  
 +
*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:
  
==Oui, mais... ==
+
**forum.yoursite.tuxfamily.org
"Oui, mais moi je veux juste ce CGI en particulier, vous ne pourriez pas me l'installer ?"
 
Non.
 
Comme cela est indiqué dans la charte, nous ne ferons pas de "cas particulier". Si nous mettons en place un service, cela sera pour tous les utilisateurs. Nous le pouvons donc pas nous permettre de mettre en place un CGI particulier pour un utilisateur, car cela nous obligerait à :
 
*mettre en place un service d'installation automatique de CGI pour tous les utilisateurs
 
*vérifier chaque CGI que nous voulons proposer aux utilisateurs (audit de sécurité)
 
*suivre les annonces de sécurité, et mettre à jour chacun de ces CGI
 
*...
 
Et nous n'avons pas à l'heure actuelle les moyens humains et logiciels pour faire cela.
 
  
==Oui mais j'ai absolument besoin de trac pour mon projet ! ==
+
**wiki.yoursite.tuxfamily.org
  
Dans ce cas tentez votre chance avec [http://flyspray.rocks.cc flyspray] ;)
+
**whatever.yourdomain.tld
  
ou sinon, choisissez de contribuer à http://vhffs.org en permettant d'ajouter un module de déploiement de trac (un utilisateur avait commencé mais n'a pu continuer par manque de temps :/)
+
*If you just deleted your htdocs folder, come on our irc channel, an admin may be able to do something for you.
  
s'il y en a qui sont motivés par http://redmine.rubyforge.org/ qu'ils nous le disent (pour nous rassurer sur la consommation de ressources du serveur par exemple) et qu'ils procèdent comme ceux qui souhaiterait trac. Il paraît que les install sur localhost fonctionnent :p
+
*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 :)
  
==Autres arguments==
+
*If you can't connect to our server, try using the passive mode (both work if your equipments are correctly configured on your side).
Pour PHP, en cas de gros soucis de charge, on peut utiliser eaccelerator, avec perl et python on est coincés.
 
  
Pour JBoss et tomcat qui nous ont aussi été demandé, là c'est plutôt côté charge du(des) serveur(s) - en plus de la sécurité - que nous avons quelques interrogations, si vous avez des benchmarks...
+
*If you have troubles removing a directory, you may have some "hidden" files. Make sure that your ftp client display them.
  
==Autres hébergeurs==
+
*If you want to use mod_rewrite in a .htaccess, start your .htaccess with:
bon si vous tenez vraiment à avoir du python, jetez un oeil (pas trop loin) à :
+
RewriteEngine On
*http://wiki.python.org/moin/FreeHosts
+
RewriteBase  /path/to/your/software  # ex: / if rules are applied on the root of your website, /forum , /wiki , ... in other cases
*http://trac.edgewall.org/wiki/CommercialServices
 
  
= Remarques diverses =
+
* Promote [[PubTuxfamily/En|TuxFamily]] with a link.
* Ne PAS mettre vos scripts PHP et TOUT FICHIER en chmod 777. Ils ne s'exécuteront pas de toute manière et cela est un grave problème de sécurité !
 
  
* pour un même projet vous pouvez avoir plusieurs espace web, par exemple pour un wiki servant à la doc et un forum utilisé pour le support utilisateur :
+
= Compatibility with some third party applications =
  
**forum.votresite.tuxfamily.org
+
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.
  
**wiki.votresite.tuxfamily.org
+
[[WebArea/Compat/MediaWiki/Fr|MediaWiki, "Your session save path appears to be invalid or is not writable" and "your database_username is too long"]].
  
**... (ou votre propre nom de domaine bien sûr...)
+
[[WebArea/Compat/Flyspray/En|Flyspray, "Paths and rights problems"]].
  
* Si vous avez supprimé votre dossier htdocs ou le répertoire du site, venez sur irc! après s'etre moqué de vous pendant une heure ou deux, un admin finira bien par vous refaire marcher votre bazard ;)
+
[[WebArea/Compat/MoinMoin|MoinMoin, "MoinMoin installation"]].
  
*Si vos transfert FTP ne se font pas intégralement, c'est que vous subissez la dure loi des quotas. Demandez donc du quota aux admins (voir section gestion du groupe)
+
[[WebArea/Compat/PHP|PHP on TuxFamily]].
* Si vous n'arrivez pas à vous connecter sur notre serveur FTP, passez en mode actif. D'ailleurs, c'est bien souvent mieux, d'être actif. Bon, là, je sors...
 
* Si après avoir transféré vous obtenez une erreur "403 Forbiden" sur votre page web, vérifiez les droits sur vos fichiers (mettez 755 par exemple).
 
* Avec filezilla, si vous obtenez l'erreur "550 can't remove directory not empty" lorsque vous essayez de supprimer un répertoire, cela signifie qu'il y a des fichiers cachés dans ce dossier, ou l'un de ces sous-dossiers. L'option "Afficher les fichiers cachés" du menu "Affichage" vous permet d'afficher ces fichiers.
 
  
= Liens utiles =
+
[[WebArea/Compat/Python|Python on TuxFamily]].

Latest revision as of 13:38, 17 October 2020

Websites



Description

A Website allows you to put some web pages online (surprising eh ?). You can use almost all php softwares but also static pages.

Supported languages

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 !).

About PHP configuration: http://hack.tuxfamily.org/phpinfo.php7 and http://hack.tuxfamily.org/phpinfo.php

Dependencies

Creation

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. (212.85.158.4 / 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.

Moderation

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)  

PHP7

In order to execute PHP7 instead of PHP5, edit/add a .htaccess file and add:

AddType application/x-httpd-php7 .php

Self-execution

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 user@ssh.tuxfamily.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/ user@ssh.tuxfamily.org: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:
    • forum.yoursite.tuxfamily.org
    • wiki.yoursite.tuxfamily.org
    • whatever.yourdomain.tld
  • 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

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.

MediaWiki, "Your session save path appears to be invalid or is not writable" and "your database_username is too long".

Flyspray, "Paths and rights problems".

MoinMoin, "MoinMoin installation".

PHP on TuxFamily.

Python on TuxFamily.