Table of Contents
Managing Subversion repositories
Creating a Subversion Repository
From Virtualmin
To setup a subversion repository, follow the steps below:
- Sign in to Virtualmin (see Account Logins and Important URLs).
- Select a domain from the drop-down in the left-hand navigation (your main domain should be already selected when you first login to Virtualmin). This is the domain you'll be adding a Subversion repository to.
- Click Edit Virtual Server
- If you haven't created any repositories before, you will need to enable them first. Click Enabled features and then select Allow Subversion repositories?
- Click Save Virtual Server. Subversion repositories have now been enabled for this domain.
- Click Services in the left-hand navigation, then click SVN Repositories. You should now see the SubVersion Repositories page
- Enter a suitable name in the Repository name field (e.g., repos )
- From the Under server drop-down, select a domain for your repository
- To enable anonymous access to your Subversion repository, select Yes for Allow anonymous read access?
- Click Create. You should now have a new repository under /home/yourusername/svn/.
- Click Return to index
Now you need to create a user for your new repository.
If you like power, you can control Subversion access without really creating any system users, and even fine tune access on a per directory level. See here on how to manually edit Subversion auth files. Otherwise, for an easy browser controlled access model, check out the following section.
Creating a Subversion user
From Virtualmin
- Sign in to Virtualmin (see Account Logins and Important URLs).
- Select a domain from the drop-down in the left-hand navigation (your main domain should be already selected when you first login to Virtualmin). This is the domain you'll be adding a Subversion user to and will be the same domain you added the subversion repository to previously.
- Click Edit Mail and FTP Users in the left-hand navigation.
You should now see a list of current users for your selected domain.
- Click Add a user to this server. to add a new user. You can also grant access to an existing user by selecting a user from the list provided. For the rest of these steps, we'll be creating a new user Note: Each field name, such as Email address, is a clickable help link that will provide a brief description of each option in a popup window.
- In the Email address field enter a suitable username for your new user. Note: Compared to other system services, the user's login name for Subversion will be the short form only, so if you enter joe here, Joe will log into Subversion with just 'joe'.
- In the Real name field enter a suitable name for your user (e.g., SubversionUser).
- The Password field will already be populated with password for your user. We recommend using the password that Virtualmin has created as they are fairly secure and you should also make a note of this password in case you need it later.
- Click Email settings and for Primary email address enabled? select No.
- Click Other user permissions And make sure FTP login enabled? , and DAV login enabled? have been set to No
- Set SubVersion login enabled? to Yes and select a Subversion repository from the list that you want to grant this user access to. To select more than one repository, hold down the Control key in Windows or the Apple key in in OS X.
- Finally, click Create to create your new Subversion user.
And you should now have a new subversion repository available at http://yourdomain.tld/svn/repos which you can access using the Username and Password you entered in the above steps.
Please be aware that you can only use one access method for the repository. Switching between http/https, file or svn+ssh will alter the file permissions (see svn+ssh and permissions). However, you can always fix a repositories permissions using the steps below.