Skip to content

Commit

Permalink
(#485) Update README links and text (#556)
Browse files Browse the repository at this point in the history
* (#485) Update README text and links

* (#485) Remove unused build status
  • Loading branch information
pauby authored Jan 17, 2024
1 parent 8594a52 commit 8b503bf
Show file tree
Hide file tree
Showing 4 changed files with 30 additions and 31 deletions.
61 changes: 30 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,34 @@
# Boxstarter

![https://ci.appveyor.com/api/projects/status/github/chocolatey/boxstarter](https://ci.appveyor.com/api/projects/status/github/chocolatey/boxstarter?svg=true&branch=master)
Repeatable, reboot resilient windows environment installations made easy using Chocolatey packages.

Repeatable, reboot resilient windows environment installations made easy using Chocolatey packages

## For more information and How Tos, visit [the official Boxstarter website](https://boxstarter.org)
For more information and How Tos, visit [the official Boxstarter website](https://boxstarter.org).

The source of the Boxstarter website can be found in the [boxstarter.org repository](https://github.com/chocolatey/boxstarter.org).

## Windows environment creation made easy
## Windows Environment Creation Made Easy

* 100% Unattended Install with *pending reboot detection* and *automatic logon*.
* Remote machine deployments
* Integrates with Hyper-V and Windows Azure VMs supporting checkpoint restore and creation
* Installation packages build on top of [Chocolatey](https://chocolatey.org) package management
* Easily install with just a [Gist and the Boxstarter Web Launcher](https://boxstarter.org/WebLauncher) or [create a private repository on a thumb drive or network share](https://boxstarter.org/InstallingPackages#InstallFromShare)
* Works on Window 7/2008 R2 and up with PowerShell 2.0 and higher
* Lots of Windows configuration utilities including installing critical updates, changing windows explorer options, and more.
* Remote machine deployments.
* Integrates with Hyper-V and Windows Azure VMs supporting checkpoint restore and creation.
* Installation packages build on top of [Chocolatey](https://chocolatey.org) package management.
* Easily install with just a [Gist and the Boxstarter Web Launcher](https://boxstarter.org/WebLauncher) or [create a private repository on a thumb drive or network share](https://boxstarter.org/InstallingPackages#InstallFromShare).
* See the [supported operating systems](https://docs.chocolatey.org/en-us/chocolatey-components-dependencies-and-support-lifecycle#supported-windows-versions) but may work on older.
* Lots of Windows configuration utilities including installing critical updates, changing Windows Explorer options, and more.

## Quickly install your favorite applications and settings, on any machine, with a gist! No pre-installed software needed

### Grab your Gist

![gist](Web/Images/gist3.PNG)
![gist](Web/Images/gist3.png)

### Launch the Boxstarter launcher

![boxstarter weblauncher](Web/Images/start.png)

## Easily package installation scripts and resources in a NuGet package
## Easily Package Installation Scripts and Resources In a NuGet Package

### A simple Hello World
### A Simple Hello World

```powershell
Import-Module Boxstarter.Chocolatey
Expand All @@ -40,11 +38,11 @@ Set-Content (Join-Path $Boxstarter.LocalRepo "HelloWorld\Tools\ChocolateyInstall
Invoke-BoxstarterBuild HelloWorld
```

### Install on another machine
### Install On Another Computer

```powershell
$creds=Get-Credential win7\mwrock
Install-BoxstarterPackage -ComputerName win7 `
$creds = Get-Credential win\mwrock
Install-BoxstarterPackage -ComputerName win `
-Package HelloWorld -Credential $creds
```

Expand All @@ -60,7 +58,9 @@ Enable-PSRemoting -Force

* [Boxstarter Website](https://boxstarter.org)
* [Mailing List](https://groups.google.com/forum/#!forum/boxstarter)
* [Twitter](https://twitter.com/chocolateynuget) / [Facebook](https://www.facebook.com/ChocolateySoftware) / [GitHub](https://github.com/chocolatey)
* [GitHub](https://github.com/chocolatey)
* [Twitter](https://twitter.com/chocolateynuget)
* [Facebook](https://www.facebook.com/ChocolateySoftware)
* [Blog](https://chocolatey.org/blog) / [Newsletter](https://us8.list-manage.com/subscribe?u=86a6d80146a0da7f2223712e4&id=73b018498d)
* [Documentation](https://boxstarter.org/whyboxstarter)
* [Community Chat](https://ch0.co/community)
Expand All @@ -73,9 +73,9 @@ Please see the [Boxstarter docs](https://boxstarter.org/whyboxstarter).

Boxstarter requires the following to work:

* OS: Windows 7 or Windows Server 2008 R2 and higher
* PowerShell Version 2 or higher
* Administrative privileges on the machine where Boxstarter is running
* Operating System: See the [Chocolatey supported Windows operating systems](https://docs.chocolatey.org/en-us/chocolatey-components-dependencies-and-support-lifecycle#supported-windows-versions).
* PowerShell Version 2 or higher.
* Administrative privileges on the machine where Boxstarter is running.

### License / Credits

Expand All @@ -87,27 +87,26 @@ If you are an open source user requesting support, please remember that most fol

## Submitting Issues

![submitting issues](https://cloud.githubusercontent.com/assets/63502/12534554/6ea7cc04-c224-11e5-82ad-3805d0b5c724.png)

* If you are having issues with a Chocolatey package, please see the [Chocolatey package triage process](https://chocolatey.org/docs/package-triage-process).
* If you are having issues with Chocolatey please see [Troubleshooting](https://github.com/chocolatey/choco/wiki/Troubleshooting) and the [FAQ](https://github.com/chocolatey/choco/wiki/ChocolateyFAQs) to see if your question or issue already has an answer.
* If you are having issues with a Chocolatey package, please see the [Chocolatey package triage process](https://docs.chocolatey.org/en-us/community-repository/users/package-triage-process#the-triage-process).
* If you are having issues with Chocolatey products please see [Troubleshooting](https://docs.chocolatey.org/en-us/troubleshooting) and the [FAQ](https://docs.chocolatey.org/en-us/faqs) to see if your question or issue already has an answer.

Observe the following help for submitting an issue:
Observe the following help for submitting an issue.

Prerequisites:
### Prerequisites

* The issue has to do with Boxstarter itself or the [Boxstarter website](https://boxstarter.org) and is not a Chocolatey package issue.
* Please check to see if your issue already exists with a quick search of the issues. Start with one relevant term and then add if you get too many results.
* When creating an issue, please ensure you read the guidance at the top which includes links for Contributing and Submitting Issues documentation.
* The issue has to do with Boxstarter itself and is not a [Boxstarter website issue](https://github.com/chocolatey/boxstarter.org), Chocolatey package issue, a Chocolatey product issue.
* Please check to see if your issue already exists with a quick search of both open and closed issues. Start with one relevant term and then add if you get too many results.
* You are not submitting an "Enhancement". Enhancements should observe [CONTRIBUTING](https://github.com/chocolatey/boxstarter/blob/master/CONTRIBUTING.md) guidelines.
* You are not submitting a question - questions are better served as [emails](https://groups.google.com/forum/#!forum/boxstarter) or [Community Chat](https://ch0.co/community).
* Please make sure you've read over and agree with the [etiquette regarding communication](#etiquette-regarding-communication).

Submitting a ticket:
### Creating an Issue

* We'll need debug and verbose output, so please run and capture the log with `-Debug -Verbose` (ie. `Install-Boxstarter -PackageName <PACKAGE NAME OR GIST> -Verbose -Debug`. If it is less than 50 lines you can submit that with the issue or if it is longer, [create a gist](https://help.github.com/articles/creating-gists/) and link it.
* **Please note** that the debug/verbose output for some commands may have sensitive data (passwords or API Keys) related so please remove those if they are there prior to submitting the issue.
* If your issue needs output from `choco.exe`, then it logs to a file in `$env:ChocolateyInstall\log\`. You can grab the specific log output from there so you don't have to capture or redirect screen output. Please limit the amount included to just the command run (the log is appended to with every command).
* Please save the log output in a [gist](https://gist.github.com) (save the file as `log.sh`) and link to the gist from the issue. Feel free to create it as secret so it doesn't fill up against your public gists. Anyone with a direct link can still get to secret gists. If you accidentally include secret information in your gist, please delete it and create a new one (gist history can be seen by anyone) and update the link in the ticket (issue history is not retained except by email - deleting the gist ensures that no one can get to it). Using gists this way also keeps accidental secrets from being shared in the ticket in the first place as well.
* Please save the log output in a [gist](https://gist.github.com) (save the file as `log.sh`) and link to the gist from the issue. You can create it as secret so it doesn't fill up against your public gists but anyone with a direct link can still get to secret gists. If you accidentally include secret information in your gist, please delete it and create a new one (gist history can be seen by anyone) and update the link in the issue (issue history is not retained except by email - deleting the gist ensures that no one can get to it). Using gists this way also keeps accidental secrets from being shared in the issue in the first place as well.
* We'll need the entire log output from the run, so please don't limit it down to areas you feel are relevant. You may miss some important details we'll need to know. This will help expedite issue triage.
* It's helpful to include the version of Boxstarter, the version of the OS, whether running on physical or virtual hardware and the version of PowerShell - the debug script should capture all of those pieces of information.
* Include screenshots and / or animated gifs whenever possible as they help show us exactly what the problem is.
Expand Down
Binary file added Web/Images/gist3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Web/Images/result.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Web/Images/start.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 8b503bf

Please sign in to comment.