Download Blackstar CMS (alpha)
This build is unstable and should not be used in production. It is made available for evaluation and to assist with the evolution of the product (feedback please!).
Start with a blank windows installation (must have .net 4.5.2 or greater)
Download the Blackstar CMS Windows Installation Package.
Right click the archive, select properties, and click the `unblock` button to allow the application to be installed as a service.
Extract the contents of the zip file
Open an administrator command prompt and change to the installer directory
Install the Blackstar CMS service with the command
> BlackstarCMSService.exe install
> BlackstarCMSService.exe start
Blackstart CMS is now installed as a service. If the computer restarts Blackstar CMS will restart with it.
http://localhost:2999and confirm that Blackstar CMS is running
These instructions are for recent versions of Ubuntu Linux. Other distributions will work with a similar high-level process (install node.js, install pm2, configure pm2)
Start with a clean Ubuntu installation
Install the required dependencies with:
> sudo apt-get install build-essential libssl-dev wget unzip
Install node.js using your preferred technique. One way is via the NodeSource binary distribution repository. Another good option is the node version manager (nvm). Note that node.js 6 is currently incompatible with Blackstar CMS because the sqlite driver does not support it.
> curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash - sudo apt-get install -y nodejs
Install pm2 (node.js process manager) with the command
> sudo npm install -g pm2
For more information on pm2 see the docs
Download the Blackstar CMS Linux Installation Package.
> wget https://blackstarcms.net/downloads/blackstar-linux.gz
Extract the zip file
> unzip blackstar-linux.gz -d blackstar
Set the permissions on the files to allow execution and change into the `package` directory.
> chmod -R 700 blackstar/package/ && cd blackstar/package
Install the `sqlite3` package
> npm install sqlite3
Register the application with pm2 using the command
> pm2 start build/es5/index.js --name "blackstar"
Save the configuration of pm2
> pm2 save
Configure pm2 to restart with the operating system by generating a startup script. E.g. if you are on Ubuntu
> sudo pm2 startup ubuntu
Reboot to check that pm2 is configured properly. Then run
> pm2 list
and confirm that blackstar is started. To see more information about the process try
> pm2 show blackstar
http://localhost:2999and confirm that Blackstar CMS is running
To see full examples of Blackstar CMS integration with AngularJS, ASP.NET MVC and others browse the sample library.
PRE-RELEASE SOFTWARE LICENSE TERMS ---------------------------------- These license terms are an agreement between Eclipse Web Solutions Pty Ltd and you. They apply to Blackstar CMS. The terms also apply to any updates, supplements, Internet-based services, and support services for this software, unless other terms accompany those items. If so, those terms apply. BY USING THE SOFTWARE, YOU ACCEPT THESE TERMS. IF YOU DO NOT ACCEPT THEM, DO NOT USE THE SOFTWARE.IF YOU COMPLY WITH THESE LICENSE TERMS, YOU HAVE THE RIGHTS BELOW. 1. INSTALLATION AND USE RIGHTS. a. Installation and Use.· You may install and test one copy of the software on your premises. You may not test the software in a live operating environment. 2. TERM. The term of this agreement is ninety days, or commercial release of the software, whichever is first. 3. PRE-RELEASE SOFTWARE. This software is a pre-release version. It may not work the way a final version of the software will. We may change it for the final, commercial version. We also may not release a commercial version. 4. FEEDBACK. If you give feedback about the software to Eclipse Web Solutions Pty Ltd, you give to Eclipse Web Solutions Pty Ltd, without charge, the right to use, share and commercialize your feedback in any way and for any purpose. These rights survive this agreement. 5. SCOPE OF LICENSE. The software is licensed, not sold. This agreement only gives you some rights to use the software. Eclipse Web Solutions Pty Ltd reserves all other rights. Unless applicable law gives you more rights despite this limitation, you may use the software only as expressly permitted in this agreement. In doing so, you must comply with any technical limitations in the software that only allow you to use it in certain ways. You may not work around any technical limitations in the software; reverse engineer, decompile or disassemble the software, except and only to the extent that applicable law expressly permits, despite this limitation; make more copies of the software than specified in this agreement or allowed by applicable law, despite this limitation; publish the software for others to copy; rent, lease or lend the software; transfer the software or this agreement to any third party; or use the software for commercial software hosting services. 6. EXPORT RESTRICTIONS. You must comply with all domestic and international export laws and regulations that apply to the software. These laws include restrictions on destinations, end users and end use. 7. SUPPORT SERVICES. Because this software is “as is,” we may not provide support services for it. 8. ENTIRE AGREEMENT. This agreement, and the terms for supplements, updates, Internet-based services and support services that you use, are the entire agreement for the software and support services. 9. LEGAL EFFECT. This agreement describes certain legal rights. You may have other rights under the laws of your country. You may also have rights with respect to the party from whom you acquired the software. This agreement does not change your rights under the laws of your country if the laws of your country do not permit it to do so. 10. DISCLAIMER OF WARRANTY. THE SOFTWARE IS LICENSED “AS-IS.” YOU BEAR THE RISK OF USING IT. ECLIPSE WEB SOLUTIONS PTY LTD GIVES NO EXPRESS WARRANTIES, GUARANTEES OR CONDITIONS. YOU MAY HAVE ADDITIONAL CONSUMER RIGHTS OR STATUTORY GUARANTEES UNDER YOUR LOCAL LAWS WHICH THIS AGREEMENT CANNOT CHANGE. TO THE EXTENT PERMITTED UNDER YOUR LOCAL LAWS, ECLIPSE WEB SOLUTIONS PTY LTD EXCLUDES THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. FOR AUSTRALIA – YOU HAVE STATUTORY GUARANTEES UNDER THE AUSTRALIAN CONSUMER LAW AND NOTHING IN THESE TERMS IS INTENDED TO AFFECT THOSE RIGHTS. 13. LIMITATION ON AND EXCLUSION OF REMEDIES AND DAMAGES. YOU CAN RECOVER FROM ECLIPSE WEB SOLUTIONS PTY LTD AND ITS SUPPLIERS ONLY DIRECT DAMAGES UP TO AU $5.00. YOU CANNOT RECOVER ANY OTHER DAMAGES, INCLUDING CONSEQUENTIAL, LOST PROFITS, SPECIAL, INDIRECT OR INCIDENTAL DAMAGES. This limitation applies to anything related to the software, services, content (including code) on third party Internet sites, or third party programs; and· claims for breach of contract, breach of warranty, guarantee or condition, strict liability, negligence, or other tort to the extent permitted by applicable law.It also applies even if Eclipse Web Solutions Pty Ltd knew or should have known about the possibility of the damages. The above limitation or exclusion may not apply to you because your country may not allow the exclusion or limitation of incidental, consequential or other damages.