mirror of
https://github.com/minio/docs.git
synced 2025-10-25 09:17:37 +03:00
bc261ad8bb
Docs have moved from min.io/docs to docs.min.io/commuinity. This fixes hard, external links to use the new subdomain. Note that some of these files are automatically pulled from elsewhere as part of the build process, so some may not carry through even after this PR merges.
126 lines
4.8 KiB
ReStructuredText
126 lines
4.8 KiB
ReStructuredText
.. _quickstart-windows:
|
|
|
|
.. |OS| replace:: Windows
|
|
|
|
This procedure deploys a :ref:`Single-Node Single-Drive <minio-installation-comparison>` MinIO server onto |OS| for early development and evaluation of MinIO Object Storage and its S3-compatible API layer.
|
|
|
|
.. note::
|
|
|
|
This documentation only covers Single-Node Single-Drive deployments.
|
|
Due to NTFS behaviors and limitations, MinIO does not recommend multi-node multi-drive deployments on Windows hosts.
|
|
|
|
Use :minio-docs:`Linux hosts <minio/linux/operations/installation.html>` or :minio-docs:`Kubernetes <minio/kubernetes/upstream/index.html>` for deploying production-ready distributed MinIO deployments.
|
|
|
|
Use Windows-based MinIO deployments for early development and evaluation.
|
|
MinIO strongly recommends Linux (RHEL, Ubuntu) systems for long-term development and production environments.
|
|
|
|
MinIO supports non-EOL Windows versions (Windows 10, Windows Server 2016+).
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
- Read, write, and execute permissions for the preferred local directory or file path
|
|
- Familiarity with using the Command Prompt or PowerShell
|
|
|
|
Procedure
|
|
---------
|
|
|
|
#. Install the MinIO Server
|
|
|
|
Download the MinIO executable from the following URL:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
https://dl.min.io/server/minio/release/windows-amd64/minio.exe
|
|
|
|
The next step includes instructions for running the executable.
|
|
You cannot run the executable from the Explorer or by double clicking the file.
|
|
Instead, you call the executable to launch the server.
|
|
|
|
#. Launch the :mc:`minio server`
|
|
|
|
In PowerShell or the Command Prompt, navigate to the location of the executable or add the path of the ``minio.exe`` file to the system ``$PATH``.
|
|
|
|
Use this command to start a local MinIO instance in the ``C:\minio`` folder.
|
|
You can replace ``C:\minio`` with another drive or folder path on the local computer.
|
|
|
|
.. code-block::
|
|
:class: copyable
|
|
|
|
.\minio.exe server C:\minio --console-address :9001
|
|
|
|
The :mc:`minio server` process prints its output to the system console, similar to the following:
|
|
|
|
.. code-block:: shell
|
|
|
|
API: http://192.0.2.10:9000 http://127.0.0.1:9000
|
|
RootUser: minioadmin
|
|
RootPass: minioadmin
|
|
|
|
Console: http://192.0.2.10:9001 http://127.0.0.1:9001
|
|
RootUser: minioadmin
|
|
RootPass: minioadmin
|
|
|
|
Command-line: https://docs.min.io/community/minio-object-store/reference/minio-mc.html
|
|
$ mc alias set myminio http://192.0.2.10:9000 minioadmin minioadmin
|
|
|
|
Documentation: https://docs.min.io/community/minio-object-store/
|
|
|
|
WARNING: Detected default credentials 'minioadmin:minioadmin', we recommend that you change these values with 'MINIO_ROOT_USER' and 'MINIO_ROOT_PASSWORD' environment variables.
|
|
|
|
The process is tied to the current PowerShell or Command Prompt window.
|
|
Closing the window stops the server and ends the process.
|
|
|
|
#. Connect your Browser to the MinIO Server
|
|
|
|
Access the :ref:`minio-console` by going to a browser (such as Microsoft Edge) and going to ``http://127.0.0.1:9001`` or one of the Console addresses specified in the :mc:`minio server` command's output.
|
|
For example, ``Console: http://192.0.2.10:9001 http://127.0.0.1:9001`` in the example output indicates two possible addresses to use for connecting to the Console.
|
|
|
|
While port ``9000`` is used for connecting to the API, MinIO automatically redirects browser access to the MinIO Console.
|
|
|
|
Log in to the Console with the ``RootUser`` and ``RootPass`` user credentials displayed in the output.
|
|
These default to ``minioadmin | minioadmin``.
|
|
|
|
#. `(Optional)` Install the MinIO Client
|
|
|
|
The :ref:`MinIO Client <minio-client>` allows you to work with your MinIO volume from the commandline.
|
|
|
|
Download the standalone MinIO server for Windows from the following link:
|
|
|
|
https://dl.min.io/client/mc/release/windows-amd64/mc.exe
|
|
|
|
Double click on the file to run it.
|
|
Or, run the following in the Command Prompt or PowerShell.
|
|
|
|
.. code-block::
|
|
:class: copyable
|
|
|
|
\path\to\mc.exe --help
|
|
|
|
Use :mc:`mc.exe alias set <mc alias set>` to quickly authenticate and connect to the MinIO deployment.
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc.exe alias set local http://127.0.0.1:9000 minioadmin minioadmin
|
|
mc.exe admin info local
|
|
|
|
The :mc:`mc.exe alias set <mc alias set>` takes four arguments:
|
|
|
|
- The name of the alias
|
|
- The hostname or IP address and port of the MinIO server
|
|
- The Access Key for a MinIO :ref:`user <minio-users>`
|
|
- The Secret Key for a MinIO :ref:`user <minio-users>`
|
|
|
|
For additional details about this command, see :ref:`alias`.
|
|
|
|
.. rst-class:: section-next-steps
|
|
|
|
Next Steps
|
|
----------
|
|
|
|
- :ref:`Connect your applications to MinIO <minio-drivers>`
|
|
- :ref:`Configure Object Retention <minio-object-retention>`
|
|
- :ref:`Configure Security <minio-authentication-and-identity-management>`
|