How to install Confluence – Windows
This article will focus on a step-by-step on detailing a Confluence installation process. This will entirely give the how to install Confluence from start process.
The images provided here are from a Windows 8 hosted machine example. However installing on other OS will be under the same steps.
- Windows 7/ Windows 8/ Windows Server 2008/ 2012
Preparation steps
Download the setup file from Atlassian Confluence. The url may change but it should be: https://www.atlassian.com/software/confluence
You can then select ‘Try it free’ for Evaluation purpose or purchase it (choices of 1-10 users / more (corporate pricing).
It makes perfect sense for individuals to purchase the 1-10 users Option as it currently is priced at $10 USD. Atlassian is even using this amount for charity, so get on the bandwagon to support Atlassian for this!
Download Confluence Installation File
There is no lack of functionality even with the $10 USD version, except the user count is for 10 max users only.
Start installation – Confluence
- Double click installation file: eg atlassian-confluence-5.10.7×64
Select Custom Install
2. Select ‘Use default ports’ – Your service port after installation is 8090
Select default port (change only if you really require customised port)
3. Select ‘Install Confluence as Service’
Install Confluence as a service
4. After the installation process is completed, you will be redirected onto your browser for further configuration process.
- Trial Installation – Just as the described words, the only reason why you should use this installation is for ‘Testing purpose’. Even for personal wiki, you should consider yourself to set under Production Installation category.
Trial installation is a no-frills installation with ’embedded DB’. This impacts performance purposes greatly in future.
- Production Installation – This is for any usage of Atlassian Confluence for long-term purpose usage.
Trial Installation / Production Installation
If you select trial Installation
5a. You will need a license key – either Evaluation key or a Production key from Atlassian Account.
Create an account under Atlassian and purchase a license key. We recommend 1-10 users for personal and small company usage.
Key in license key – confluence
6a. The only reason you will choose Connect to JIRA is when your company uses JIRA concurrently for development tracking purposes.
Choose ‘Manage users and groups within Confluence’.
Select Manage Users And Groups Within Confluence
7a. Select ‘Start’. Configuration has completed with Confluence Install with ‘Trial Installation’.
Press Start – Configuration completed
You will then be able to start right off away and you will see the below screen.
Confluence is installed and you can get to work!
Confluence – Completed Installation
If you select Production Installation
If you had selected this, the only difference here is “You need to use an ‘external database source’ to keep all the data of your wiki”. Not using an embedded database means you are not using Atlassian coded database for immediate deployment.
Hence you need a little more steps.
5b. Select External Database – PostgreSQL. This is the easiest installation method with Production Installation.
Select External Database – PostgreSQL
6b. Download Postgresql and install using its installation file.
Download page: https://www.postgresql.org/download/windows/
Remember, DO NOT Choose the latest Postgresql version. You should always choose a backdated 1-2 versions away from the newest postgresql. As shown in image I am using Postgresql-9.5.4-2 in order to cater to Confluence 5.10.7
Any newer and it might not work. You will have to uninstall and reinstall everything again with correct versions in that case.
Install Postgresql with its installation file
7b. Go to pgAdmin III / pgAdmin to access the GUI for PostgreSQL.
So the goal here is to “create a Database and user with access to the Database” using PostgreSQL. After doing this, you can let Confluence access the database with the very settings you have input.
pgAdmin is installed together with PostgreSQL installation.
Postgresql – PGAdmin
8b. This is what you see on pgAdmin
pgAdmin page Main
9b. Right click Login Roles – New Login Role
Right click Login role, create user
10b. Create the login role eg confAdmin
Ensure you set the password for this user and allow it to create databases + create roles.
Settings for login role
11b. After create login role, right click Database and select ‘New Database’.
Create database – postgresql
12b. Select created login role, ie confAdmin in this case
Select created login role as its owner
13b. This is what you see on the created database.
What you see on postgresql DB Creation
14b. From here, you have a ready user – able to access Database: confluence.
What you need to do is to get back to your browser and input the exact details you just created with postgreSQL. Put them in and voila.
Input parameters to access postgresql confluence
15b. Select Example Site – and you are good to go.
Always select example site. It just makes things easier
16b. Select “Manage users and groups within Confluence”
Select Manage users and groups in Confluence
17b. Create a system admin account. This is typically your system account where you should not give access to any users. Each user should have his/her own account, with a System Admin account as a spare. (Recommended)
Create the site admin details
18b. Select start and you can finally begin adding items to the wiki.
Select ‘Start’ and start rolling
19b. This is an example once you have fully setup and followed the steps above.
- You are either using an unsupported DB (eg too new Postgresql / mysql versions)
- Or you have configured the instance where it cannot poll to its DB, due to firewall rules etc. A local DB hosted on the same machine will not present this problem.
Example of a working Confluence
And test to add a few pages and ensure things are working before you call your boss and say “Job Completion!”.
Comments