CrushFTP supports allowing users to self register on your server. This is not automatic, and you must configure and personalize this experience. You have extensive controls over the entire process.

The first step is to create a username in the user manager that will be used for this. Keep it simple, and use a basic simple password too. Do not assign them any additional privileges as this will be a public account that is used for doing registrations.

I suggest an account name "register" with a password of "register". This will allow you to use a URL like this to reach the registration page:

When this page loads, it looks at the URL to see the name of the HTML file. The default is "messageForm" and its fine to keep it this way. It then asks the server to give it the registration form named "messageForm" as long as it has been assigned to the "register" user. If it hasn't, you will just get a blank page. If you do not use this custom login.html page, the registration can still be processed, its just a little less intuitive to the user that it was processed.

The next step is to make a form named "messageForm" in the Preferences, WebInterface, Custom Forms. There are only two required items for the form, the username and password. Every field item must have a 'name' that starts with 'registration_'.

So for the two required items, they would be 'registration_username' and 'registration_password'. You can have more items, just look at a user.XML file to see other element names. So if you wanted to include email in the registration, you would do 'registration_email'. If you want to prepend the user to one group you can use 'pendingSelfRegistration' as a dropdown box and set the possible group values in it. The user that way will be part of the selected group, just will need to be enabled by the group admin.


Now that you have the form defined, and the registration user created, you need to assign this form to the registration user. You do this in the User Manager. Use the Quick Jump drop down to get to the WebInterface section. Then assign your form there.


Save all changes, and you are ready to test. When you login as the registration username, and go to that specific HTML page, this form will be loaded and sent in a 'registration' request mode.

This is what the form looks like for the user:


When a user self registers, their account is created as a disabled user, and added to a specific group called "pendingSelfRegistration". This group will contain all users that signup in this way. You can then review users in the group, enable their accounts, and remove them from the group. Or you may simply delete the user if they are not approved.

You can also do more advanced things with this as well. You can attach events that send email notifications thanking users for registering, and for letting you know there is a user that is pending. This is done via the events section, and using an event for when a user "accepts disclaimer" as this is the same form.

If you need further customizations, you can customize the messageForm.html page with your own copy and use it instead. Just be sure to use the appropriately named form name based on the html file's name.

If you want to enable the self registered accounts without user interference, you can use the following event, on the register user. Set the path according to the machine that is hosting CrushFTP. The path should be something like: /Applications/CrushFTP8OSX/users/MainUsers/{registration_username}/user.XML Or C:/Program Files/CrushFTP8_PC/users/MainUsers/{registration_username}/user.XML attachments

attachments attachments attachments attachments

Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
assignform.png 17.2 kB 1 29-Dec-2020 05:25 Ben Spink
registration.png 31.8 kB 3 29-Dec-2020 05:25 Halmágyi Árpád
selfregister auto enable0.png 116.0 kB 1 29-Dec-2020 05:25 Halmágyi Árpád
selfregister auto enable1.png 54.7 kB 3 29-Dec-2020 05:25 Halmágyi Árpád
selfregister auto enable2.png 22.9 kB 3 29-Dec-2020 05:25 Halmágyi Árpád
selfregister auto enable3.png 22.3 kB 3 29-Dec-2020 05:25 Halmágyi Árpád
selfregister auto enable4.png 63.2 kB 3 29-Dec-2020 05:25 Halmágyi Árpád
signupform.png 180.8 kB 2 29-Dec-2020 05:25 Halmágyi Árpád
« This page (revision-10) was last changed on 29-Dec-2020 05:25 by Halmágyi Árpád
G’day (anonymous guest)
CrushFTP10 | What's New