platform/.pkb/4_dependencies_and_setup/pkb-installation-guide.md

93 lines
3.3 KiB
Markdown
Raw Normal View History

# Protevus Platform Installation Guide
This guide will walk you through the process of installing the Protevus Platform on your system. It covers different installation methods and provides step-by-step instructions to ensure a smooth installation process.
## Prerequisites
Before you begin, ensure that you have the following prerequisites installed on your system:
- **Dart SDK** (version X.X.X or later)
- **Git** (for cloning the Protevus Platform repository)
## Installation Methods
You can install the Protevus Platform using one of the following methods:
1. **Using Git (Recommended)**
2. **Downloading the ZIP Archive**
Choose the method that best suits your needs and follow the corresponding instructions.
### Method 1: Using Git (Recommended)
This method is recommended for developers who want to stay up-to-date with the latest changes and contribute to the project.
1. Open your terminal or command prompt and navigate to the directory where you want to install the Protevus Platform.
2. Clone the Protevus Platform repository by running the following command:
~~~bash
git clone https://github.com/protevus/platform.git
~~~
3. Navigate into the cloned repository directory:
~~~bash
cd platform
~~~
4. Install the required dependencies by running the following command:
~~~bash
dart pub get
~~~
5. Follow the [Environment Setup Guide](environment-setup.md) to configure your environment and set up the necessary dependencies.
6. Once the environment is set up, you can start the Protevus Platform development server by running the following command:
~~~bash
dart bin/server.dart
~~~
7. Verify the installation by accessing the development server in your web browser (e.g., `http://localhost:8080`).
### Method 2: Downloading the ZIP Archive
This method is suitable for users who want to quickly install the Protevus Platform without using Git.
1. Visit the [Protevus Platform GitHub repository](https://github.com/protevus/platform) and click on the "Code" button.
2. Select "Download ZIP" to download the ZIP archive of the Protevus Platform codebase.
3. Extract the downloaded ZIP archive to a directory of your choice.
4. Open your terminal or command prompt and navigate to the extracted directory.
5. Install the required dependencies by running the following command:
~~~bash
dart pub get
~~~
6. Follow the [Environment Setup Guide](environment-setup.md) to configure your environment and set up the necessary dependencies.
7. Once the environment is set up, you can start the Protevus Platform development server by running the following command:
~~~bash
dart bin/server.dart
~~~
8. Verify the installation by accessing the development server in your web browser (e.g., `http://localhost:8080`).
## Next Steps
After successfully installing the Protevus Platform, you can proceed to the following steps:
- Explore the project documentation to learn more about the platform's features and capabilities.
- Start building your applications using the Protevus Platform.
- Contribute to the project by submitting bug reports, feature requests, or pull requests on the [GitHub repository](https://github.com/protevus/platform).
- Join the Protevus Platform community and engage with other developers, ask questions, and share your experiences.
Congratulations! You have successfully installed the Protevus Platform on your system. Happy coding!